MapiRecipDesc (Simple MAPI)

A MapiRecipDesc structure contains information about a message sender or recipient.

Quick Info

Header file:

MAPI.H

typedef struct {

ULONG ulReserved

ULONG ulRecipClass;

LPTSTR lpszName;

LPTSTR lpszAddress;

ULONG ulEIDSize;

LPVOID lpEntryID;

} MapiRecipDesc, FAR *lpMapiRecipDesc;

Members

ulReserved

Reserved; must be zero.

ulRecipClass

Contains a numeric value that indicates the type of recipient. Possible values are:

Value	Constant	Meaning
0	MAPI_ORIG	Indicates the original sender of the message.
1	MAPI_TO	Indicates a primary message recipient.
2	MAPI_CC	Indicates a recipient of a message copy.
3	MAPI_BCC	Indicates a recipient of a blind copy.

lpszName

Pointer to the display name of the message recipient or sender.

lpszAddress

Optional pointer to the recipient or sender s address; this address is provider-specific message delivery data. Generally, the messaging system provides such addresses for inbound messages. For outbound messages, the lpszAddress member can point to an address entered by the user for a recipient not in an address book (that is, a custom recipient).

The format of an address pointed to by the lpszAddress member is [address type][e-mail address]. Examples of valid addresses are FAX:206-555-1212 and SMTP:M@X.COM.

ulEIDSize

The size, in bytes, of the entry identifier pointed to by the lpEntryID member.

lpEntryID

Pointer to an opaque entry identifier used by a messaging system service provider to identify the message recipient. Entry identifiers have meaning only for the service provider; client applications will not be able to decipher them. The messaging system uses this member to return valid entry identifiers for all recipients or senders listed in the address book.